domainCREATE Request
Function
This request is used to register a domain.
Requirements
-
The request can only be processed if the domain has not already been registered.
-
Before registering the domain you must create the Contacts that are referenced in the request.
Verification
-
Domains in the “failed” state are initially bound to the 30-day connection period. After the connection, the risk assessment is carried out.
-
If a contact handle (type “PERSON” or “ORG”) with verified contact data is used, every domain registered with a domain CREATE request is automatically verified, provided that the verification result of the contact remains unchanged as “success”.
-
A domain CREATE request is also executed if contacts without a phone number or email address are used.
-
When the domain is passed to the risk assessment without one of the final statuses “connect” or “serverHold”, the domain status “pendingCreate” is set. An information message is output in the response.
Request Parameters
A Domain CREATE request is composed of the fields of the "Domain" data object and some other parameters, which are described below:
K/V Keyword | XML Namespace and Element | Occurrence min - max |
Type / Length | Value Range | Description |
---|---|---|---|---|---|
Action | domain:create | 1 | enumeration | create-erule | This is the request type. |
Version | - | 1 | enumeration | version-erule | This is the version. The keyword is only relevant for requests in the key/value format. |
CtId | ctid | 0 - 1 | token 3 - 64 |
Any visible Unicode character (according to Unicode version 3.1) | This is the unique transaction ID which is issued by the client. |
Common Mistakes
- The requested domain already exists.
- The status of the requested domain is „redemptionPeriod“.
- One of the Contacts stated in the request does not meet the requirements of the role to be assigned to it.
- The Nameserver Predelegation Check failed. You will find descriptions of the checks that are executed in the DENIC document DENIC-23.
Examples
- xml
- k/v
format: xml
request: domainCREATE
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0" xmlns:dnsentry="http://registry.denic.de/dnsentry/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<domain:create>
<domain:handle>domain-example-nserver.de</domain:handle>
<domain:contact role="holder">DENIC-1000022-EXAMPLE-XML-PERSON</domain:contact>
<domain:contact role="abusecontact">DENIC-1000022-EXAMPLE-XML-GR</domain:contact>
<domain:contact role="generalrequest">DENIC-1000022-EXAMPLE-XML-ABUSE</domain:contact>
<dnsentry:dnsentry xsi:type="dnsentry:NS">
<dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
<dnsentry:rdata>
<dnsentry:nameserver>ns1.denic.de</dnsentry:nameserver>
</dnsentry:rdata>
</dnsentry:dnsentry>
<dnsentry:dnsentry xsi:type="dnsentry:NS">
<dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
<dnsentry:rdata>
<dnsentry:nameserver>ns1.domain-example-nserver.de</dnsentry:nameserver>
<dnsentry:address>81.91.170.12</dnsentry:address>
</dnsentry:rdata>
</dnsentry:dnsentry>
</domain:create>
<ctid>xml-74ba5155</ctid>
</registry-request>
format: xml
response: domainCREATE
status: pendingCreate
<?xml version="1.0" encoding="UTF-8"?>
<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
<tr:transaction>
<tr:stid>a503e644-635c-4253-b598-84d0c2296a97</tr:stid>
<tr:ctid>xml-74ba5155</tr:ctid>
<tr:result>success</tr:result>
<tr:message level="info" code="53000080014">
<tr:text>Domain "Status" is "pendingCreate"</tr:text>
</tr:message>
</tr:transaction>
</registry-response>
format: k/v
request: domainCREATE
Version: 5.0
Action: CREATE
Domain: domain-example-nserver.de
Holder: DENIC-1000022-EXAMPLE-PERSON
Generalrequest: DENIC-1000022-EXAMPLE-GR
Abusecontact: DENIC-1000022-EXAMPLE-ABUSE
Nserver: ns1.denic.de
Nserver: ns2.denic.de
CTID: cba-987654321
format: k/v
response: domainCREATE
status: pendingCreate
Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d
INFO: 53000080014 Domain "Status" is "pendingCreate"
STID: 3727d839-497f-4ef9-8aa5-0a1ea16a8c95
CTID: cba-987654321